home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / CHAMBERS / FREEFNGR / !FreeFngr / !Help < prev    next >
Text File  |  1998-08-15  |  4KB  |  94 lines
  1. === !FreeFinger Help File
  2.  
  3. Motivation
  4.  
  5. If you do not know what "finger" is or how to use it stop now. You will
  6. be wasting your time.
  7.  
  8. I wanted to have an implementation of finger which did not lock up the
  9. WIMP even in a TaskWindow. 
  10.  
  11. Health Warning
  12.  
  13. !FreeFinger is blacksmithed code. It is ancient code from the days of UNIX soldered
  14. onto a pedagogical RISC-OS application using a collection of freeware libraries.
  15. The building is done with Acorn Desktop C version 4. It probably should be done
  16. with Toolbox and C++ (or Java and JDK-Classlib or Ada95 and an old windsock).
  17.  
  18. It works. On my machine using Internet 5.02 with RO3.70. If it does not work
  19. for you remember the advice from Zen and the Art of Motorcycle maintenence,
  20. "For assembling the item great peace of mind is required."
  21.  
  22. It it fails you then given the nature of networking you are probably using
  23. a stressed system. If you are going to write a problem report to the e-mail
  24. at the bottom of the helpfile then decide if you have the time to re-run
  25. a test in a calmer state of mind and log the results OR hey, maybe it's
  26. not worth bothering. It's free and you probably want to do what you were
  27. doing when it went wrong. !FreePing is supplied "as is" and is not warranted
  28. to function on any particular machine. Also using !FreeFinger does not imply
  29. any liability for consequential damages.
  30.  
  31. Copyright
  32.  
  33. The software !FreeFinger is Copyright © Peter Chambers 1998.
  34. Certain parts and libraries have copyrights from other authors whose
  35. copyright does not preclude inclusion.
  36.  
  37. !FreeFinger is FREEWARE and may be used by anyone. It may be distributed
  38. freely by non-profit means. If a fee is charged for copying it that fee
  39. must be strictly to cover the costs of the copying process. All copying
  40. and distribution must be of the whole software including all relevent
  41. notices, credits and documentation.
  42.  
  43. It must not be sold for commercial gain or distributed as part of a
  44. "cover disc" or profit making software library without the permission of
  45. the author. In the interests of users distribution by on-line means is
  46. preferred and attempts will be made to ensure the latest version is available
  47. on-line.
  48.  
  49. Credits
  50.  
  51. The basic function of !FreeFinger is based on the NetBSD Finger.c ported to RISC-OS
  52. by Tom Hughes who seems to have written much of the RISC-OS freeware starting
  53. with FreeNet (though others are now following his sterling example).
  54.  
  55. The application skeleton is based (a lot!) on Client_Ex by Duncan Ferguson.
  56. Duncan took the attitude that other authors could make what they wanted of it.
  57. I used it to learn how to hack network applications under a dozy GUI. Thanks.
  58.  
  59. The look'n'some'of'feel and the sprites come from !Finger by Tim Howarth which
  60. is a front end for the command line Finger. I lifted the idea of the Most Recently Used
  61. hostnames from !Ping. Tim encouraged me to just get on with it and replace !Finger
  62. with !FreeFinger in the interests of the users. He also strongly advocated using BASIC
  63. as the size of the runimage is small. Even with the Best Basic In The World I had to
  64. write it in C as the sight of lines like "block!8=&0700008" brings on the red mist.
  65.  
  66. The next layer down is the ShellLib by Julian Smith which I needed for the output
  67. window. This uses DeskLib also by Julian. He took the same helpful attitude as
  68. the others are replied promptly to my news plea when I found that DeskLib had
  69. no "txt" element.  One day the ghosts of RiscOS-lib will be finally laid.
  70. Until that time free libraries like this which have what programmers actually
  71. use will be our stopgap.
  72.  
  73. The network interface is provided by NetLib which has the names of Andy Mell
  74. and Stewart Brodie in it's credits. Long ago they tried to explain to me why RiscOS
  75. cannot use "close()" for sockets. Stewart used the word "disjoint" to explain.
  76. This does not detract from the immense value they have given Acorn programmers
  77. in NetLib. Since it matches the interface is Comer and Stevens straight from
  78. the box that's the one that got used. I gather that Adam Goodfellow did the
  79. "gettimeofday()" function which cannot quite guarantee the microseconds so
  80. the time results get granularised in the code (which should always have been
  81. possible).
  82.  
  83. History
  84.  
  85.  
  86. 0.02 removed debug logfile fprintf()s for distribution
  87.  
  88. 0.01 improved socket problems, added async connect()
  89.  
  90. 0.00 First hacked from FreePing.
  91.  
  92. Author
  93.  
  94. Peter Chambers         mailto:  freeping@hightown.demon.co.uk